home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / ptolemy / install next >
Text File  |  1993-07-26  |  13KB  |  297 lines
  1. Ptolemy Installation:
  2. --------------------
  3.  
  4.      Ptolemy is a large software system that relies on a properly
  5. configured  software environment.  There are many things that can
  6. go wrong in getting Ptolemy running.  For instance, the windowing
  7. system  may  not  be  the same one we use, or it may be used in a
  8. different way.  There is also some configuration required by each
  9. user  in  order  to use the graphical interface.  The information
  10. for doing this is given in the Pigi document, section  2  of  the
  11. Almagest.   Here  we  give  the basic information required to get
  12. from an FTP archive or distribution tape to being able to run the
  13. system.
  14.  
  15.  
  16. 1.1 Basic Ptolemy Installation
  17.  
  18.      First note that the approximate disk space requirements  are
  19. (for  the Sun-4 distribution; other distributions are roughly the
  20. same size):
  21.  
  22.             Ptolemy: 49 Mbytes
  23.             Ptolemy (after you optionally remake): 64 Mbytes
  24.             Gnu subset: 16 Mbytes
  25.  
  26.      Create a user "ptolemy" together with  a  home  directory
  27. for  the  "ptolemy"  user.  Once the "ptolemy" user account has
  28. been created, log in or su to user "ptolemy"  If  you  do  not
  29. wish to create a user called "ptolemy" see below for an alter-
  30. native.
  31.  
  32. If you are loading Ptolemy from a tape, do the following:
  33.  
  34. a.   cd /tmp (or any directory where you  have  write  permission
  35.      and there is at least 30 Mbytes of free disk space). (If you 
  36.      do not have this amount free, you can extract the four files 
  37.      one at a time. See the tar man page for details, or ask your
  38.      system administrator)
  39.  
  40. b.   Load the tape into your drive
  41.  
  42. c.   mt -f /dev/nrst8 rewind
  43.      (This rewinds the tape -- change the  device  name  if  your
  44.      tape drive has a different name.)
  45.  
  46. d.   tar xf /dev/nrst8
  47.  
  48. If you have used FTP to down load  the  files,  then  cd  to  the
  49. directory  that  contains  the  "*tar.Z" files you downloaded via
  50. FTP.
  51.  
  52. Now, whether you've used tape or FTP, there should be a number of
  53. large  "*tar.Z" files in your current directory.  Proceed as fol-
  54. lows:
  55.  
  56. 1.   zcat pt-0.4.1.doc.tar.Z | ( chdir ~ptolemy/..; tar xf - )
  57.      (this uncompresses the documentation, changes directory  the
  58.      parent  of  the  "ptolemy" user, and then creates all of the
  59.      documentation files.)
  60.  
  61. 2.   zcat pt-0.4.1.src.tar.Z |  ( chdir ~ptolemy/..; tar xf - )
  62.      (this uncompresses the src and creates  the  source  files.)
  63.      You must not skip this step.  Ptolemy depends on these files
  64.      being present.  Note that you may get a few warning messages
  65.      during this and the following step about the tar program not
  66.      being able to create some directories because  they  already
  67.      exist.  This is expected (the same directory is mentioned in
  68.      several of the tar files), so you need not worry.
  69.  
  70. 3.   If you are running the DecStation (MIPS) version of Ptolemy:
  71.      zcat pt-0.4.1.mips.tar.Z |  ( chdir ~ptolemy/..; tar xf - )
  72.      If you are running the Sun 4 (Sparc, IPC, IPX, etc) version:
  73.      zcat pt-0.4.1.sun4.tar.Z |  ( chdir ~ptolemy/..; tar xf - )
  74.      If you are running the HP (hppa) version:
  75.      zcat pt-0.4.1.hppa.tar.Z |  ( chdir ~ptolemy/..; tar xf - )
  76.      (this uncompresses the binaries and creates  the  executable
  77.      files.)  Note that is possible to install both the Sun-4 and
  78.      the DecStation binaries on the same file system as different
  79.      directories are used for each set of binaries.
  80.  
  81. 4.   You no longer need the pt-0.4.1.xxx.tar.Z files that you got 
  82.      from the FTP site or the tape.  Remember to delete these 
  83.      files to free up storage space.
  84.  
  85. 5.   cd ~ptolemy
  86.      (change directories to the ptolemy root directory)
  87.  
  88. 6.   Edit ~ptolemy/.rhosts, adding a line for your  system  (This
  89.      gives  pigi  permission to create an RPC server process with
  90.      the rsh command ).  The added  line  will  be  of  the  form
  91.      "hostname  ptolemy",  you can find the correct hostname with
  92.      the Unix command "hostname".  Users will also  need  entries
  93.      in  their .rhosts files to allow the server process to start
  94.      up.
  95.  
  96. 1.2 Installation with out creating a "ptolemy" user
  97.  
  98.      The preferred installation technique, as indicated above, is
  99. to create a user called "ptolemy"  The reason for this is that
  100. running Ptolemy requires an appropriate user  configuration.   At
  101. minimum,   the   user's  path  must  be  set  up  properly.   The
  102. "ptolemy" user is also configured to run an  X  window  manager
  103. (twm)  with  suitable  X  resources  that  are known to work.  In
  104. troubleshooting an  installation,  having  the  "ptolemy"  user
  105. properly configured can be very valuable.
  106.  
  107.      However, we recognize the some sites resist the creation  of
  108. fictitious  users.   Consequently,  Ptolemy can be installed any-
  109. where.  If you do this, every Ptolemy user  must  set  a  PTOLEMY
  110. environment  variable  to point to the root directory of Ptolemy.
  111. The installation is the same as above, except  that  "~ptolemy"
  112. is replaced with "$PTOLEMY"
  113.  
  114. 1.3. Special considerations for installation under Open Windows
  115.  
  116.      Ptolemy was developed using the X11R4 or X11R5 distributions
  117. from MIT.  It will run successfully under Open Windows version 2.
  118. There are problems with running the graphic interface  with  Open
  119. Windows  version  3, however.  Some users have had no problems at
  120. all, but others have  had  intermittent  problems  such  as  "bad
  121. match"  errors.   We  believe  this  may be a problem with the X-
  122. server supplied with the Open  Windows  3.0,  but  the  error  is
  123. elusive and we have not yet tracked it down.
  124.  
  125.      In order for all utilities included with  this  distribution
  126. to work under Open Windows (either version), you must install the
  127. shared libraries for the Athena widgets (the freely  redistribut-
  128. able  widget  set  from the MIT X11 distribution), which are pro-
  129. vided with this distribution under  the  "~ptolemy/athena.sun4"
  130. directory.   To  install  them, become root and copy all files in
  131. that  directory  into  "/usr/openwin/lib"  (or,  if  you   have
  132. installed   Open   Windows   in   a   non-standard   place,  into
  133. "$OPENWINHOME/lib").  If you do not wish to do this, you  could
  134. leave  them  in  place  and  have every Ptolemy user change their
  135. LD_LIBRARY_PATH     environment      variable      to      search
  136. "~ptolemy/athena.sun4"  before  "/usr/openwin/lib."   Consult
  137. the Unix manual entry for the "ld" program to learn more  about
  138. this.
  139.  
  140.      After installation, the ptolemy account will contain several
  141. scripts  for  starting  up  X11R5  (Xrun), Open Windows with olwm
  142. (Xrun.ow), or Open Windows with twm (Xrun.ow.twm).
  143.  
  144. 1.4 GNU Installation
  145.  
  146.      For convenience, some software from the Free Software  Foun-
  147. dation  is  included on the distribution tape.  This includes the
  148. compiler used to make Ptolemy, which is  also  the  compiler  you
  149. will use to extend Ptolemy.  Note that this is not a complete set
  150. of Gnu software.
  151.  
  152.      To install the ptolemy gnu subset, proceed as follows:
  153.  
  154. 1.   cd /usr/tools
  155.  
  156. 2.   Check to see if there is already a "gnu" directory.  If  so,
  157.      you  probably  don't want to load the ptoelmy gnu files here
  158.      and should pick a different location  for  the  ptolemy  gnu
  159.      subset (be especially careful in step 6 below).  If there is
  160.      not already a "gnu" directory, then do the following command:
  161.      mkdir gnu
  162.  
  163. 3.   If you have Ptolemy on tape,  then cd to the directory you 
  164.      used to download the files from the tape in the "Basic 
  165.      Ptolemy installation" steps above.  
  166.  
  167. 4.   If you have used FTP to get the ptolemy gnu file, then cd to
  168.      the directory that contains the files you downloaded via FTP.
  169.  
  170. 5.   You should now have a gnu-xxx.tar.Z file (where  xxx  is  an
  171.      architecture  supported by ptolemy such as "sun4", "hppa", or 
  172.      "mips") in your current directory.
  173.  
  174. 6.   Note, if they was already a "gnu" directory in  "/usr/tools"
  175.      (see  step  (2)  above) you will need to change the commands
  176.      below.  Replace "/usr/tools" with the  name  of  the  parent
  177.      directory  of  the  location you have picked for the ptolemy
  178.      gnu subset.
  179.  
  180.      If you are running on a Sun 4 (Sparc, IPC, IPX, etc) then:
  181.      zcat gnu-sun4.tar.Z | ( chdir /usr/tools; tar xf - )
  182.      If you are running on a DecStation (MIPS) then:
  183.      zcat gnu-mips.tar.Z | ( chdir /usr/tools; tar xf - )
  184.      If you are running on a DecStation (MIPS) then:
  185.      zcat gnu-hppa.tar.Z | ( chdir /usr/tools; tar xf - )
  186.  
  187. 7.   You no longer need the gnu-xxx.tar.Z file that you got from
  188.      the FTP site or the tape.  Remember to delete this file to
  189.      free up storage space.
  190.  
  191.      The gnu tar files also contain the gnu source  code  in  the
  192. /usr/tools/gnu/src  directory.  You  will  save  disk  space  and
  193. Ptolemy will still run fine if you delete all of the  gnu  source
  194. files.  However, if you plan to redistribute the tools (give them
  195. to anyone else) you must include sources, according  to  the  Gnu
  196. Public  License.   Therefore, it may be a good idea to keep these
  197. source files around.
  198.  
  199.      It is also possible to build Ptolemy with Sun's port of AT&T's
  200. cfront compiler, version 2.1.  To do so, you must completely re-
  201. build Ptolemy.  The libraries on the tape were produced by the 
  202. Gnu C++ compiler and are not interoperable with cfront code.
  203.  
  204. 1.5 Testing the installation
  205.  
  206. 7.   You no longer need the gnu-xxx.tar.Z file that you got from
  207.      the FTP site or the tape.  Remember to delete this file to
  208.      free up storage space.
  209.  
  210.      The gnu tar files also contain the gnu source  code  in  the
  211. /usr/tools/gnu/src  directory.  You  will  save  disk  space  and
  212. Ptolemy will still run fine if you delete all of the  gnu  source
  213. files.  However, if you plan to redistribute the tools (give them
  214. to anyone else) you must include sources, according  to  the  Gnu
  215. Public  License.   Therefore, it may be a good idea to keep these
  216. source files around.
  217.  
  218.      It is also possible to build Ptolemy with Sun's port of AT&T's
  219. cfront compiler, version 2.1.  To do so, you must completely re-
  220. build Ptolemy.  The libraries on the tape were produced by the 
  221. Gnu C++ compiler and are not interoperable with cfront code.
  222.  
  223. 1.5 Testing the installation
  224.  
  225.      Note that the following tests assume that you have created a
  226. user "ptolemy" and installed the system there.   One advantage of
  227. such an installation, is that the user "ptolemy"  already  has  a
  228. working .cshrc and .login file to make startup easier.
  229.  
  230.      To test Ptolemy:
  231.  
  232. 1.   login as ptolemy
  233.  
  234. 2.   If the X server is not already running,  the  .login  script
  235.      will attempt to start it.  If your installation is different
  236.      from ours, you may need to modify .login  to  work  at  your
  237.      site  (in  particular,  you  may need a different path vari-
  238.      able).
  239.  
  240. 3.   cd demo
  241.  
  242. 4.   pigi
  243.  
  244. 5.   Follow instructions in section 2  of  the  Almagest  titled,
  245.      "Running the Ptolemy Demos" (section 2.3.1).
  246.  
  247.      Note that the ptolemy user provides a model of a user  prop-
  248. erly  configured  to  run  ptolemy.   All  the .files in the home
  249. directory are set up according  to  the  tastes  of  the  Ptolemy
  250. authors,  and according the standard use of windowing software in
  251. the Ptolemy development group.
  252.  
  253. 1.6 Rebuilding Ptolemy from Source
  254.  
  255.      If you wish to rebuild Ptolemy from  source  (this  step  is
  256. recommended  if  you  plan  to do major development work, such as
  257. adding a new domain), it  is  simply  a  matter  of  editing  the
  258. appropriate  configuration  file  and  typing  "make"  This is
  259. explained in a bit more detail below.
  260.  
  261.      Configuration files live  in  the  root  directory  of  your
  262. ptolemy  system.   If you have installed PT as the user "ptolemy"
  263. then these file are in the ~ptolemy home directory.   The  confi-
  264. guration  file  are all named "config-xxx.mk" where the "xxx"
  265. is something like "sun4" for a Sun-4 system or "mips" for a DecS-
  266. tation.   They are included by other makefiles and define symbols
  267. specifying compiler flags, the directory where  X  include  files
  268. are located, etc.  The file that is used is determined by replac-
  269. ing "xxx" above by the value of the ARCH environment variable.
  270.  
  271.      If you wish to rebuild using cfront  rather  than  g++,  use
  272. config-cfront.mk  as  a starting point to produce your configura-
  273. tion file.  This has been tested with cfront 2.1 on a Sun-4;  for
  274. other platforms, you may need to do some tweaking.
  275.  
  276.      To rebuild the system, first adjust the configuration param-
  277. eters in the appropriate configuration file.  For example, if you
  278. are using the Gnu tools on a Sun-4, then you will need to  adjust
  279. the "config-sun4.mk" file.
  280.  
  281.      Next, run make.  We  recommend  using  Gnu  make,  which  is
  282. included  in  the  gnu subset.  (Make sure that the Gnu tools are
  283. installed correctly.) Ultrix make will definitely not work.
  284.  
  285.      You will get some warnings from the compiler, but  the  fol-
  286. lowing warnings can safely be ignored:
  287. any warning about file_id' defined but not used.
  288.  ../../src/kernel/Tokenizer.cc:85: warning: cast discards `const'
  289. from pointer target type
  290.  ../../../../src/domains/thor/kernel/fprval.cc:56:       warning:
  291. ordered comparison between signed and unsigned
  292.  ../../src/ptcl/PTcl.cc:<n>: warning: cast discards `const'  from
  293. pointer target type (this warning may appear four times with dif-
  294. ferent values of <n>)
  295.  ../../src/ptcl/ptclMain.cc:75: warning: unused variable `ptcl'
  296.  
  297.